home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / util / libs / DigNet_2_1.readme < prev    next >
Text File  |  1997-05-03  |  4KB  |  105 lines
  1. Short:    Easy ser network handle for games/progs
  2. Author:   kenny@bgnett.no (Kenneth "Kenny" Nilsen)
  3. Uploader: kenny@bgnett.no (Kenneth "Kenny" Nilsen)
  4. Version:  2.1
  5. Type:     util/libs
  6. Replaces: util/libs/DigNet*
  7. Requires: kickstart 2.0+
  8.  
  9.  
  10. $VER: dignet.library 2.1 (12.03.97)
  11.  
  12. Copyright (C) 1997 by Digital Surface/Kenneth "Kenny" Nilsen.
  13. All rights reserved.
  14.  
  15.  
  16. NEWS:    - Resource tracking ! Including debug tools that uses this feature.
  17.     - Great speed improvments on ReadNet()/WriteNet()/WriteString()
  18.       You no longer have to read/write bytes to get correct result,
  19.       the routines do it for you which increase the speed ~250%.
  20.       ReadString() still have to work the way it does.
  21.     - Buffer size now defaults to 8 KB buffer instead of 2 KB.
  22.     - Stupid bugs on the ReadString()/WriteString(). Fixed!
  23.  
  24. CHANGES:  - ReadString() now returns -1 instead of 1 if buffer overflow!
  25.       - Cleaned up the autodoc for types/explinations.
  26.  
  27.  
  28. Includes a simple terminal program that uses the dignet.library and take
  29. advantages of the speed improvments in 2.1+. Source and binary included!
  30.  
  31. ----------------------------------------------------------------------------
  32.  
  33. INTRODUCTION
  34.  
  35. Always  wanted to make games or programs that could support serial network ?
  36. This will maybe be the solution for you.  This library will do all the dirty
  37. work  for  you.   All  you need to do is to call read and write functions to
  38. communicate.   No  more hustling with setting up structures, ports and pools
  39. to use the device.  No more DoIO.
  40.  
  41. Tested with duart.device 0 and 1 with nullmodem-cable.  Tested agains modem.
  42. Should work fine with serial.device and compatible devices.  Do not use with
  43. other devices such as trackdisk.device etc.
  44.  
  45. The library functions are fully re-entrant.
  46.  
  47. IMPORTANT:
  48.  
  49. Read the autodoc section /---background--- and ---notes--- for important
  50. notes!
  51.  
  52. Developer files for assembler and C included. Notify me if the C includes
  53. are incomplete, I am not a C guru at all (assembler is fine though ;)
  54.  
  55. This is version 2.1 (still beta). Let me know if you find bugs.
  56. Email me for bugs or comments. I am happy to receive ideas.
  57.  
  58.  
  59. TODO:
  60.  
  61. - SetBaud() function to easily change the baud rate.
  62. - Error code on what type of error (out of memory, device couldn't be opened,
  63.   couldn't allocate port etc.)
  64.  
  65.  
  66. IDEAS:
  67.  
  68. - Functions for modem > sending ATZ/ATDT, parsing OK/RING/CONNECT/NO CARRIER
  69.   etc. Let me know what you think.
  70. - Resource tracker for program using the library (clean up device(s) if
  71.   program crashes)
  72.  
  73.  
  74.  
  75. Regards,
  76. ---
  77.   #*Kenny*#  mailto:kenny@bgnett.no  ''"\./"``  http://www.bgnett.no/~kenny/
  78.          Developer/GM Digital Surface (opinions by me are my own!)
  79. ---
  80.  
  81.  
  82. ============================= Archive contents =============================
  83.  
  84. Original  Packed Ratio    Date     Time    Name
  85. -------- ------- ----- --------- --------  -------------
  86.     1680     960 42.8% 12-Mar-97 12:08:36 +dignet.library
  87.    17664    5846 66.9% 12-Mar-97 11:55:48 +dignet.doc
  88.      560     268 52.1% 09-Mar-97 09:46:46 +dignet_lib.fd
  89.      413     266 35.5% 12-Mar-97 13:20:28 +dignet.h
  90.      368     257 30.1% 12-Mar-97 13:20:54 +dignet.i
  91.      247     144 41.7% 09-Mar-97 09:46:40 +dignet_lib.i
  92.     1646     445 72.9% 09-Mar-97 09:53:48 +dignet_lib.h
  93.      181     128 29.2% 25-Feb-97 14:52:34 +dignet.h
  94.     2524    1499 40.6% 12-Mar-97 12:54:42 +DignetKILL
  95.     2500    1308 47.6% 12-Mar-97 13:24:58 +DigNet_2.1.readme
  96.     2096    1210 42.2% 12-Mar-97 12:05:36 +DignetTERM
  97.     3074    1129 63.2% 15-Dec-96 12:22:46 +Digital.macs
  98.     7665    2915 61.9% 12-Mar-97 12:05:34 +DignetTerm.asm
  99.     6895    2270 67.0% 08-Jan-97 15:01:54 +Startup.asm
  100.     2345    1155 50.7% 12-Mar-97 13:23:12 +CSAA.txt
  101.     1914     963 49.6% 12-Mar-97 13:15:56 +DignetDebug.doc
  102.     1764    1017 42.3% 12-Mar-97 13:08:04 +DignetLIST
  103. -------- ------- ----- --------- --------
  104.    53536   21780 59.3% 13-Mar-97 16:08:54   17 files
  105.